home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / jnos / cmdshelp / ax25 < prev    next >
Text File  |  1994-08-09  |  14KB  |  356 lines
  1.  
  2. ax25 <subcommands>
  3.  
  4.      All AX.25 parameters are configurable per interface.  Commands of
  5.      the form 'ax25 <command>' set the default or global values.  Use
  6.      the 'ifconfig <iface> ax25 <command>' form to set or show the
  7.      specific interface values.
  8.      
  9.      To set the system default ax.25 parameters, you must do so BEFORE
  10.      attaching interfaces.  After attaching, you must use the 'ifconf
  11.      <iface> ax25' command form.
  12.      
  13.     ax25 alias <aliascall>
  14.  
  15.      The alias command shows or sets the system's alias call. If
  16.      netrom is enabled, this modifies the same call as the 'netrom
  17.      alias' command.  The 'ax25 alias' command is NOT needed in that
  18.      case!  If netrom is not used, this command allows an alias name
  19.      to be set  such that users can connect to it.
  20.      
  21.      
  22.     ax25 bbscall <bbs_call>
  23.  
  24.      For all interfaces NOT set to <mycall> or <bbs_call>, change or
  25.      set the id to 'bbscall'.  'ax25 mycall' will not override bbscall
  26.      once bbscall has been set.  See also 'iface <iface> bbscall
  27.      <bbs_call>'.
  28.      
  29.           #Example: (in the following order)
  30.           
  31.           'ax25 mycall <mycall>'
  32.           'attach <(all interfaces)>'
  33.           'ax25 bbscall <bbscall>'      sets all ifaces to bbscall
  34.           
  35.           or
  36.           
  37.           'iface <name> bbscall <bbscall>'   sets only iface <name>     
  38.     ax25 bc <iface>
  39.  
  40.      The bc command  forces an immediate broadcast on the given
  41.      interface.  The particular interface or port must have been
  42.      enabled with the ax25 bcport command first. If this is so, the ID
  43.      will be broadcast as set with the ax25 bctext commands.
  44.      
  45.           ax25 bc port1
  46.     
  47.  
  48.     ax25 bcinterval [<seconds>]
  49.  
  50.      (B)  The bcinterval displays or sets the time in seconds between
  51.      broadcasts.  On display, both the interval and the countdown
  52.      values are shown. Default = 600 (10 minutes).
  53.      
  54.      
  55.     ax25 bcport [<iface>] [on | OFF]  (Deleted in 110x16)
  56.  
  57.      Display or set the active interfaces for ax.25 broadcasting (i.e.
  58.      beacons).  You must add this statement for each port that the
  59.      system should beacon on.  Default is off.
  60.      
  61.           ax25 bcport port1 on
  62.           
  63.           
  64.     ax25 bctext ["broadcast text"]
  65.  
  66.      Display or set the default text to be sent for broadcast messages
  67.      sent out every ax25 bcinterval seconds.
  68.      
  69.  
  70.      See also 'ifconfig <iface> beacon ["bctext"].
  71.  
  72.           ax25 bctext "This is the beacon text!"
  73.           
  74.           
  75.     ax25 blimit [<secs>]
  76.  
  77.      (B)  Display or set the default AX25 retransmission backoff
  78.      limit.  Normally each successive AX25 retransmission is delayed
  79.      by twice the value of the previous interval; this is called
  80.      binary exponential backoff.  When the backoff reaches the blimit
  81.      setting it is held at that value.  Default = 30.
  82.      
  83.      To prevent the possibility of "congestive collapse" on a loaded
  84.      channel, blimit should be set at least as high as the number of
  85.      stations sharing the channel.  Note that this is applicable only
  86.      on actual AX25 connections; UI frames will never be retransmitted
  87.      by the AX25 layer.
  88.      
  89.           #Set ax25 blimit to 15 seconds
  90.           ax25 blimit 15          
  91.           
  92.     ax25 digipeat [<iface>] [ON | off]
  93.  
  94.      Display or set digipeating per interface. If cross-band or AXIP
  95.      digipeating is to be allowed, digipeating must be enabled on both
  96.      interfaces involved.  Default is on.
  97.      
  98.           # Display digipeat status of port1
  99.           ax25 digipeat port1
  100.           
  101.           
  102.     ax25 flush
  103.  
  104.      Clears the AX.25 "heard" list (see ax25 heard and ax25 hport)
  105.      
  106.  
  107.     ax25 heard [<iface>]
  108.  
  109.      Display the AX.25 "heard" list. For each interface that is
  110.      configured to use AX.25 heard listing (see 'ax25 hport'), a list
  111.      of all ax25_source addresses heard on that interface is shown,
  112.      along with a count of the number of packets heard from each
  113.      station and the time since each station was last heard. The
  114.      maximum length of the heard table can be set with the 'ax25
  115.      hsize' command.  If interface is given, only the heard list for
  116.      that interface is displayed.
  117.  
  118.           ax25 heard port1
  119.           
  120.           
  121.     ax25 hport [<iface>] [ON | off]
  122.  
  123.      Display or set the status of the ax.25 heard feature.  If no
  124.      interface is given, all interfaces with ax.25 heard enabled will
  125.      be listed.  If interface is given, the status of ax.25 heard for
  126.      that interface is shown.  Default is on.
  127.           
  128.           #Display port1 status
  129.           ax25 hport port1
  130.           
  131.           
  132.     ax25 hsize [<size>]
  133.  
  134.      Set or display the size of the heard list table.  Default is 0
  135.      which means no limit.
  136.      
  137.      
  138.     ax25 irrt [<milliseconds>]
  139.  
  140.      (B)  Display or set the initial value of smoothed round trip time
  141.      to be used when a new AX25 connection is created.  The actual
  142.      round trip time will be learned by measurement once the
  143.      connection has been established.  Default is 5000ms.
  144.           #Set irtt to 10 seconds  (10000 milliseconds)
  145.           ax25 irtt 10000
  146.           
  147.           
  148.     ax25 kick <axcb>
  149.  
  150.      Force a retransmission on the specified AX.25 control block.  The
  151.      control block address can be found with the ax25 status command.
  152.      This is useful to reactivate connections that have long time-out
  153.      values.
  154.      
  155.  
  156.     ax25 maxframe [<count>]
  157.  
  158.      (B)  Establish the maximum number of frames that will be allowed
  159.      to remain unacknowledged at one time on new AX.25 connections.
  160.      This number cannot be greater than 7. Without <count> it will
  161.      display the current setting. Note that the maximum outstanding
  162.      frame count only works with virtual connections. UI frames are
  163.      not affected. Also note that for optimal performance, a value of
  164.      1 should be used.  Default is 1 frame.
  165.      
  166.      
  167.     ax25 maxwait [<msec>]
  168.  
  169.      Sets a limit (in msec) to the retry timeout values.  Default =
  170.      30000 (30 secs).  A value of 0 disables maxwait.
  171.      
  172.      
  173.     ax25 mycall [<ax25call>]
  174.  
  175.      Display or set the default local AX.25 address.  The standard
  176.      format is used, (e.g. WG7J or KA7EHK-5).  This command must be
  177.      given before any attach commands using AX.25 mode are given.
  178.           
  179.           ax25 mycall wg7j-3
  180.           
  181.           
  182.     ax25 paclen [<size>]
  183.  
  184.      (B)  This sets the default paclen used when attaching interfaces
  185.      that will carry AX.25 connections. See also 'ifconfig <iface>
  186.      paclen'. Default is 256 bytes.
  187.      This parameter limits the size of I-fields on new AX.25
  188.      connections.  If IP datagrams or fragments of datagrams larger
  189.      than paclen are transmitted, they will be transparently
  190.      fragmented at the AX.25 level, sent as a series of I frames, and
  191.      reassembled back into a complete IP datagram or fragment at the
  192.      other end of the link.  IP datagrams will not be affected if this
  193.      parameter is greater than or equal to the MTU of the associated
  194.      interface.
  195.      If NET/ROM communication is configured, the NetRom MTU value
  196.      should be Paclen - 20. !!!  The Net/Rom header takes 20 bytes,
  197.      and is part of the AX25 data.  Default netrom mtu is 236.
  198.      
  199.      Note1:  the AX.25 Level 2 Version 2 definition specifies a
  200.      maximum paclen of 256 bytes. Some systems are not equipped to
  201.      handle larger packets (e.g. G8BPQ based systems), so be careful
  202.      when using this parameter.
  203.      
  204.      Note2:  see also the discussion on paclen, mtu etc., elsewhere in
  205.      the document.
  206.      
  207.  
  208.     ax25 pthresh [<size>]
  209.  
  210.      (B)  Display or set the poll threshold to be used for new AX.25
  211.      Version 2 connections.  The poll threshold controls
  212.      retransmission behavior as follows. If the oldest unacknowledged
  213.      I-frame size is less than the poll threshold, it will be sent
  214.      with the poll (P) bit set if a time-out occurs. If the oldest
  215.      unacked I-frame size is equal to or greater than the threshold,
  216.      then a RR or RNR frame, as appropriate, with the poll bit set
  217.      will be sent if a time-out occurs.
  218.      The idea behind the poll threshold is that the extra time needed
  219.      to send a "small" I-frame instead of a supervisory frame when
  220.      polling after a time-out is small, and since there's a good
  221.      chance the I-frame will have to be sent anyway (i.e., if it were
  222.      lost previously) then you might as well send it as the poll.  But
  223.      if the I-frame is large, send a supervisory (RR/RNR) poll instead
  224.      to determine first if retransmitting the oldest unacknowledged I-
  225.      frame is necessary; the time-out might have been caused by a lost
  226.      acknowledgment.  This is obviously a tradeoff, so experiment with
  227.      the poll threshold setting. The default is 128 bytes, one half
  228.      the default value of <paclen>
  229.      
  230.  
  231.     ax25 reset <axcb>
  232.  
  233.      Delete the AX.25 connection control block at the specified
  234.      address. This deletes a connection and everything associated with
  235.      it. The control block address can be found with the 'ax25 status'
  236.      command.
  237.      
  238.  
  239.     ax25 retries [<count>]
  240.  
  241.      (B)  Limit the number of successive unsuccessful retransmission
  242.      attempts  on  new AX.25  connections.  If this  limit is
  243.      exceeded, link re-establishment is attempted.  If the link can't
  244.      be re-established in <count> times, then the connection  is
  245.      abandoned and all queued data is deleted.  Default is 5.
  246.           
  247.     ax25 route [<subcommand>]
  248.  
  249.      Without optional subcommands, display the AX.25 routing table
  250.      that specifies the digipeaters to be used  in reaching a given
  251.      station.
  252.  
  253.  
  254.        ax25 route add <target> <iface> [digis ...]
  255.  
  256.         Add an entry to the AX.25 routing table.  An automatic 'ax25
  257.         route add' is executed if digipeaters are specified in an AX25
  258.         link from the node or a connection is received from a remote
  259.         station via digipeaters.  Such automatic routing table entries
  260.         won't override locally created entries, however. <target> is
  261.         the destination call to reach via digipeaters <iface> is the
  262.         interface this is a route for.(I.e. allows different digi
  263.         routes for different interfaces.) [digis...] is a list of one
  264.         or more digipeaters, separated by spaces.
  265.           
  266.           ax25 route add k7uyx-1 port1 wg7j wa7tas n7dva
  267.           
  268.           
  269.        ax25 route drop <target> <iface>
  270.  
  271.         Drop an entry for <target> from the AX.25 routing table.
  272.  
  273.                     ax25 route drop k7uyx-1 port1
  274.           
  275.           
  276.        ax25 route mode <target> <iface> [vc|dg|interface]
  277.  
  278.         Sets the interface ip mode to one of  vc | datagram |
  279.         interface for target.  This indicates how ip links to the
  280.         destination call <target> should be established.  If nothing
  281.         is given for a certain destination or target, the interface
  282.         default mode is used, which defaults to datagram.  (See also
  283.         the 'mode' command).
  284.         vc        is a virtual circuit (ax25 connected mode, meaning
  285.                   that ip frames are sent using ax.25 connections)
  286.         datagram  is unconnected mode, (AX25 UI frames).
  287.         interface is the default interface mode, as set with the
  288.                   'mode' command.
  289.         
  290.           ax25 route mode k7uyx-1 port1 vc
  291.           
  292.     ax25 status [<axcb>]
  293.  
  294.      Without an argument, display a one-line summary of each AX.25
  295.      control block.  If the address of a particular control block is
  296.      specified, the contents of that control block is shown in more
  297.      detail. Note that the send queue units are frames, while the
  298.      receive queue units are bytes.
  299.      
  300.     ax25 t3 [<milliseconds>]
  301.  
  302.      (B)  Display or set the AX.25 idle "keep alive" timer. Value is
  303.      in milliseconds. Default is 0, i.e. no 'keep-alive' polling.
  304.      
  305.  
  306.     ax25 t4 [<seconds>]
  307.  
  308.      (B)  Display or set the AX.25 Link "redundancy" timer. Value is
  309.      in seconds. When no exchange has been had during this time the
  310.      link is reset and closed. Default = 900 seconds (15 minutes).
  311.      
  312.  
  313.     ax25 timertype [LINEAR|exponential|original]
  314.  
  315.      (B)  Sets or displays the type of timer used for retransmission
  316.      and recovery.  Linear means that each retry will use a time-out
  317.      that is RTT greater then the previous time-out. I.e. 4 sec, 8
  318.      sec, 12 sec, 16 seconds etc.  Exponential means that each retry
  319.      will use a time-out that is twice as large as the previous time-
  320.      out. I.e. 4 seconds, 8 seconds, 16 seconds, 32 seconds etc.
  321.      Original means that each retry will use a time out that is twice
  322.      the RTT, i.e. 4 seconds, 8 seconds, 8 seconds, 8 seconds, etc.
  323.      Default is linear.
  324.      
  325.           ax25 timertype exponential
  326.  
  327.  
  328.     ax25 ttycall [ttycall]
  329.  
  330.      Set or display the tty-link call for direct keyboard access.
  331.      Remember to have both 'attended on' and 'mbox attend on' to be
  332.      able to use this function.
  333.      
  334.      
  335.     ax25 version [n]
  336.  
  337.      (B)  Display or set the version of the AX.25 protocol to attempt
  338.      to  use  on  new connections.  Version 1 is the version that does
  339.      not use the poll/final bits.  Default is version 2.
  340.      
  341.  
  342.     ax25 window [<size>]
  343.  
  344.      (B)  Set the number of bytes that can be pending on an AX.25
  345. receive queue  beyond which  I  frames will be answered with RNR
  346. (Receiver Not Ready) responses. This presently applies only to
  347. suspended interactive  AX.25  sessions,  since incoming  I-frames
  348. containing  network (IP, NET/ROM) packets are always processed
  349. immediately and are not placed on the receive queue.  However, when an
  350. AX.25 connection carries both interactive and network packet traffic,
  351. an RNR generated because of backlogged interactive traffic will also
  352. stop network packet traffic from being sent.  Default is 512 bytes.
  353.  
  354.      
  355.  
  356.